Inside Macintosh: QuickDraw GX Objects /

Chapter 4 - Colors and Color-Related Objects / Colors and Color-Related Objects Reference

Color Set Functions / Creating and Manipulating Color Set Objects

GXCloneColorSet

You can use the GXCloneColorSet function to clone a color set--that is, to add a reference to it and increment its owner count.

gxColorSet GXCloneColorSet(gxColorSet source);

source

A reference to the color set to clone.

function result

A reference to the cloned color set.

DESCRIPTION

The GXCloneColorSet function increments the owner count of the color set referenced in the source parameter. You typically use this function when you want to create another reference to an existing color set rather than creating a distinct copy of the color set.

This function returns as its function result a reference to the color set--the same reference you pass in as the source parameter. it also increments the color set's owner count.

SPECIAL CONSIDERATIONS

If you attempt to clone a color set object used by an onscreen view device, this function posts a colorSet_access_restricted warning.

ERRORS, WARNINGS, AND NOTICES

Errors
colorSet_is_nil
Warnings
colorSet_access_restricted	(debugging version)

SEE ALSO

Owner counts for color set objects are discussed in the section "Copying, Comparing, and Cloning Color Sets and Color Profiles" beginning on page 4-44, and in the section "Manipulating Owner Counts" beginning on page 4-46.

To examine the owner count of a color set, use the GXGetColorSetOwners function, described on page 4-69. To decrement the owner count of a color set, use the GXDisposeColorSet function, described on page 4-65.